home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / src / Games / xblockbuster / xblockbuster.man.txt < prev    next >
Encoding:
Text File  |  1995-05-03  |  11.0 KB  |  331 lines
  1.  
  2.  
  3.  
  4. XBLOCKBUSTER(6)                                   XBLOCKBUSTER(6)
  5.  
  6.  
  7. NNAAMMEE
  8.        xblockbuster - game
  9.  
  10. SSYYNNOOPPSSIISS
  11.        xxbblloocckkbbuusstteerr _[_p_l_a_y___g_r_o_u_n_d_]
  12.  
  13. DDEESSCCRRIIPPTTIIOONN
  14.        The play ground is either the anonymous public play ground
  15.        (no argument), a named public playground  or  a  privately
  16.        owned  directory.  The list of available named public play
  17.        grounds is obtained by giving "-" as the play ground argu-
  18.        ment.
  19.  
  20.        The  object  of  the  game is to collect as many points as
  21.        possible by _b_u_s_t_i_n_g through _b_l_o_c_k_s of various types with a
  22.        ball  that reflects from the blocks and from a pallet con-
  23.        trolled by mouse movement.
  24.  
  25.        The ball must be seen as a high-energy particle that pene-
  26.        trates  the  block  before  being  repelled.   If  it gets
  27.        repelled into another block it will find its own  way  out
  28.        again.   This  process, which often leads to surprises, is
  29.        known as _t_u_n_n_e_l_l_i_n_g_.
  30.        (By design, tunnelling only occurs along a horizontal con-
  31.        nection  between  blocks  or  along the vertical sides, so
  32.        never vertically between blocks.)
  33.  
  34.        As the game progresses,  balls  are  launched  faster  and
  35.        faster.  When the speed has reached it maximum, the pallet
  36.        is gradually, though cumulatively, shrunk.  Be aware  that
  37.        the  maximum launch speed (see below), and hence the point
  38.        from which the pallet is shrunk, is only 2/3 of the  speed
  39.        limit,  and the effect is much larger than that of hitting
  40.        a speeder (but of course you may hit them often).
  41.  
  42.        The pallet is convex.  Hence reflection is a  function  of
  43.        both  the incoming angle and the excentricity of the point
  44.        of impact.  If the pallet is sufficiently convex  (differs
  45.        from stage to stage), the ball may even rebound.
  46.  
  47.        The mouse buttons control the pallet: LEFT moves it up one
  48.        row, MIDDLE moves it all the way down again.  Each ball is
  49.        launched with the RIGHT mouse button.
  50.  
  51.        A stage can be halted by closing the window, or moving the
  52.        pointer out of the window.  Be advised however,  that  the
  53.        game will resume immediately upon opening the window.
  54.  
  55.        During  a game, the score, number of balls left and speeds
  56.        are shown.  The speeds are represented by  up  to  3  thin
  57.        lines (one for each ball), above a thick line representing
  58.        the speed limit.  The short  vertical  bar  indicates  the
  59.        launch  speed  (black  upon  reaching  the  maximum launch
  60.        speed, white below that).  If, during a  stage,  you  have
  61.  
  62.  
  63.  
  64.                          16 November 1992                       1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. XBLOCKBUSTER(6)                                   XBLOCKBUSTER(6)
  71.  
  72.  
  73.        busted a 'double' or 'triple' brick, your bonus multiplier
  74.        will also be displayed at the top.
  75.  
  76.        A game can be saved in between stages with the Escape key.
  77.        At  this  point,  as  well as at the end of the game, your
  78.        score is logged.  The score board shows scores, number  of
  79.        balls  left  between  parentheses  if  any  and user name.
  80.        Finally, an indication of your current pallet shrinkage is
  81.        given.
  82.  
  83. NNOOTTEESS
  84.        In  order to avoid infinite loops (i.e., the ball(s) never
  85.        reflecting from the pallet), a ball will, upon hitting too
  86.        many  solid  bricks,  undergo  a horizontal shift, propor-
  87.        tional to, but opposite to the current horizontal speed.
  88.  
  89.        The score board imposes a maximum on the number of entries
  90.        for  any  given  user  name.  If your current score didn't
  91.        make it onto the score board, it will be displayed at  the
  92.        bottom.
  93.  
  94.        If  a  score  entry  is detected which obviously must have
  95.        originated from a saved game which for some reason "died",
  96.        a  `+'  is  appended  and  the entry will hence forward be
  97.        treated as any completed game.
  98.  
  99.        A common problem players encounter is that of losing track
  100.        of  their  mouse.   Be  advised  that  mouse movement only
  101.        alters the horizontal pallet position, but  the  mouse  of
  102.        course  may move vertically as well.  If your mouse is not
  103.        neatly perpendicular to the reflection plate, you may find
  104.        yourself  outside the window, halting play.  For this rea-
  105.        son the horizontal crosshair is shown at the  window  bor-
  106.        der, helping you to keep track of the mouse.
  107.  
  108. CCRREEAATTIIOONN OOFF PPLLAAYY GGRROOUUNNDDSS
  109.        A  private  play  ground  can be created in any directory.
  110.        The stages can be defined from the ascii map  codes  using
  111.        any text editor They must be numbered consecutively from 0
  112.        with the total number (i.e., one  more  than  the  highest
  113.        number)  available  in  the file nb_stages.  Furthermore a
  114.        directory 'save' and an empty file 'scores' must  be  cre-
  115.        ated.
  116.  
  117.        Individual  stages  can be tried in the public play ground
  118.        "try" (q.v. 'try'), provided you have write access.
  119.  
  120. TTYYPPEESS OOFF BBLLOOCCKKSS
  121.        CODE   NAME             REPRESENTATION
  122.  
  123.        ' '    clear space      white
  124.        #      solid wall       black
  125.        /,\    launchpad        black with arrow (like solid wall)
  126.          The balls enters the stage diagonally at the tip of the arrow.
  127.  
  128.  
  129.  
  130.                          16 November 1992                       2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. XBLOCKBUSTER(6)                                   XBLOCKBUSTER(6)
  137.  
  138.  
  139.    BBRRIICCKKSS
  140.        0      solid brick      75% gray
  141.          Scores 1 on each hit.
  142.  
  143.        1-9    hit bricks       white with border (and slanted
  144.        bars)
  145.          Requires as many hits as their are bars (plus 1),
  146.          each scoring equal to how often you have hit it.
  147.          The stage is over when no such bricks remain.
  148.  
  149.        a-e,j  bonus bricks     50% gray with value inscribed
  150.          Requires value/10+1 hits before scoring.
  151.  
  152.    MMAAGGIICC
  153.        A      absorber         25% gray (no border)
  154.        ^      emitter          black (like solid wall)
  155.          The ball is absorbed and emitted (whilst being
  156.        reflected).
  157.  
  158.        C      clipper          pair of scissors between "> <"
  159.          (On 2nd hit) Clips 10% off the pallet.
  160.          By design, the remnants litter the screen!
  161.          [Until the end of the current stage only.]
  162.  
  163.        D      double           "double"
  164.          (On 2nd hit) Doubles all subsequent hit values.
  165.          [Until the end of the current stage only.]
  166.  
  167.        E      extra ball       "+O+"
  168.          (On 2nd hit) Adds an extra ball to the stock.
  169.  
  170.        G      gap              the danger sign (! in a triangle)
  171.          (On 2nd hit) The ball is lost.
  172.          [As if it would have left the stage.]
  173.  
  174.        H      halt             maze of small squares
  175.          Successively takes 10, 20 and 30% of the speed.
  176.  
  177.        I      invisible brick  white (like open space)
  178.          Turns into a single hit brick when first hit, scoring 1.
  179.  
  180.        L      launch ball      "=O="
  181.          (On 2nd hit) Launches an extra ball.
  182.          [Behaves like an 'extra ball' from 3 balls in game.]
  183.  
  184.        M      mine             "kaboom" in dashed border
  185.          (On 3rd hit) Blows up all adjacent bricks (no score);
  186.          leaving debris 'refractor's.
  187.  
  188.        P      pause            maze of small squares with launch-
  189.        pad images.
  190.          (On 8th hit) Takes 30% of the excessive launch speed.
  191.  
  192.        R      refractor        dashed border with crosses
  193.  
  194.  
  195.  
  196.                          16 November 1992                       3
  197.  
  198.  
  199.  
  200.  
  201.  
  202. XBLOCKBUSTER(6)                                   XBLOCKBUSTER(6)
  203.  
  204.  
  205.          Interchanges motion along the axes.
  206.  
  207.        S      speeder          concentric borders
  208.          Adds speed (up to the speed limit; then pallet shrink-
  209.        age).
  210.  
  211.        T      triple           "triple"
  212.          (On 3rd hit) Triples all subsequent hit values.
  213.          [Until the end of the current stage only.]
  214.  
  215.        U      undo             "undo"
  216.          Restores the last block busted (with 0 hit count).
  217.  
  218.        W      open window      bracketed set of vertical lines
  219.        %      closed window     black (like solid wall)
  220.          Alternates between the two states upon each hit.
  221.  
  222.        X      expander         a pallet image between "< >"
  223.          (On 4th hit) Expands the pallet.
  224.          [Equivalent to twice the full launch speed shrinkage.]
  225.          [Effective in the next stage only.]
  226.  
  227.  
  228. XX DDeeffaauullttss
  229.        The  resource name _X_B_l_o_c_k_b_u_s_t_e_r can be used to control the
  230.        color the bricks to be displayed.  Each brick has  both  a
  231.        foreground  and  background  color  that can be displayed.
  232.        The format is brick_c_o_d_e_fg or brick_c_o_d_e_bg.   _c_o_d_e  repre-
  233.        sents the brick code, as detailed above.  Therefore a line
  234.        such as:
  235.  
  236.        XBlockbuster.brick0_fg:       green
  237.  
  238.        Makes the foreground color of the solid brick green.
  239.  
  240.        In addition, the  resource  _a_l_t_e_r_n_a_t_e___b_r_i_c_k_s  exists.   If
  241.        selected,   alternate brick patterns will be used on color
  242.        displays.  The alternate bricks tend to take coloring bet-
  243.        ter  than  the standard bricks.  If you want to use alter-
  244.        nate bricks, add the line:
  245.  
  246.        XBlockbuster.alternate_bricks:  True
  247.  
  248.        to your .Xdefaults file.
  249.  
  250.        The coloring information and alternate  brick  request  is
  251.        ignored on black and white systems.
  252.  
  253.  
  254.  
  255. FFIILLEESS
  256.        stagemm                       [optional] bookkeeping program
  257.  
  258.        The location of the following is installation depedent.
  259.  
  260.  
  261.  
  262.                          16 November 1992                       4
  263.  
  264.  
  265.  
  266.  
  267.  
  268. XBLOCKBUSTER(6)                                   XBLOCKBUSTER(6)
  269.  
  270.  
  271.        stage.skel                    skeleton stage
  272.        STAGES.                       anonymous public play ground
  273.        STAGES.*                      named public play grounds
  274.                                      (including a try out environment)
  275.        XBlockbuster.ad               Sample Xdefaults for xblockbuster.
  276.  
  277.  
  278. BBUUGGSS
  279.        When  two balls hit the same brick simultaneously, one may
  280.        leave a shadow on the stage.
  281.  
  282.        Sometimes a ball image is left  when  the  window  is  re-
  283.        opened.
  284.  
  285.        If  the  ball hits the bottom corners of the playing area,
  286.        they will at times reflect back in  a  reverse  direction,
  287.        instead of reflecting downward and out of bounds.
  288.  
  289.        XBlockbuster  uses a public colormap for systems which use
  290.        color.  If it is unable to get all the colors it wants, it
  291.        will  use  black and white for the bricks it was unable to
  292.        color.  If using alternate bricks, it can be difficult  to
  293.        differentiate bricks without the coloring.
  294.  
  295.        None  of the standard command line X arguements are inter-
  296.        perted.  Likewise, none of the standard X defaults (in the
  297.        .Xdefaults file) are used.
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.                          16 November 1992                       5
  329.  
  330.  
  331.